ATOM Documentation

← Back to App

Specialist Domains

Specialist Domains enable agents to develop expertise in specific functional areas, with domain-based routing ensuring tasks are handled by agents with the right specialization.

Overview

Agents can specialize in specific functional domains like data analysis, code execution, or integrations. This specialization enables:

  • **Expert Routing**: Tasks automatically routed to domain experts
  • **Efficient Execution**: Specialists complete tasks faster and more accurately
  • **Clear Accountability**: Know which agent handles which domain
  • **Scalable Teams**: Build teams of complementary specialists

Core Concepts

What are Domains?

Domains represent functional areas where agents can develop expertise:

DomainPurposeExample Tasks
**Data Analysis**Analytics and reportingGenerate reports, create charts, analyze trends
**Code Execution**Running code and scriptsExecute Python, run tests, deploy applications
**Integrations**External service connectionsCall APIs, handle webhooks, sync data
**Communication**Messaging and outreachSend emails, post to Slack, manage campaigns
**Automation**Workflow and schedulingCreate triggers, schedule tasks, automate processes

Domain Proficiency

Agents develop proficiency through:

  1. **Capability Acquisition**: Learn capabilities within the domain
  2. **Task Execution**: Successfully complete domain tasks
  3. **Experience Accumulation**: Build track record of success
  4. **Certification**: Achieve official domain specialist status

Proficiency Levels

LevelDescriptionRequirements
**Novice**Learning domain basics1-2 capabilities, <70% success rate
**Competent**Can handle standard tasks3-5 capabilities, 70-80% success rate
**Proficient**Handles complex tasks reliably5-10 capabilities, 80-90% success rate
**Expert**Domain authority, can train others10+ capabilities, >90% success rate

How Domains Work

Task Routing

When a task arrives, the system:

  1. **Analyzes Request**: Determines which domain the task belongs to
  2. **Finds Specialists**: Identifies agents with expertise in that domain
  3. **Selects Best Match**: Chooses specialist based on availability and proficiency
  4. **Routes Task**: Sends task to the selected specialist

Becoming a Specialist

Agents become domain specialists through:

1. Learn Domain Capabilities
   ↓
2. Execute Domain Tasks Successfully
   ↓
3. Build Track Record (High Success Rate)
   ↓
4. Achieve Required Proficiency Level
   ↓
5. Obtain Specialist Certification

Multi-Domain Agents

Agents can specialize in multiple domains:

  • **Primary Domain**: Main area of expertise
  • **Secondary Domains**: Additional areas of competence
  • **Generalists**: Agents with basic proficiency across multiple domains

Domain Marketplace

The marketplace enables:

Discovery

  • Browse available domains and their requirements
  • Find specialists for specific domains
  • View domain capability templates
  • Access best practices and patterns

Capability Sharing

  • Share domain capabilities across tenants
  • Reuse proven capability configurations
  • Contribute domain expertise to community
  • Learn from other specialists

Specialist Directory

  • Find certified specialists by domain
  • Review specialist profiles and success rates
  • Select specialists for specific tasks
  • Provide feedback on specialist performance

Leadership Certifications

Specialists can earn advanced certifications:

QUEEN (Multi-Domain Specialist)

Expert in 2+ domains with 85%+ proficiency in each:

Example QUEEN Agent:
- Primary: Data Analysis (92% proficiency)
- Secondary: Automation (88% proficiency)
- Certification: Multi-domain specialist

Responsibilities:
- Handle complex cross-domain tasks
- Coordinate multiple specialists
- Ensure quality across domains

ADMIRAL (Multi-Capability Specialist)

Expert in 3+ capabilities at autonomous level:

Example ADMIRAL Agent:
- Capabilities: api_call, webhook_handler, data_connector
- All at autonomous maturity level
- Certification: Multi-capability specialist

Responsibilities:
- Lead complex integration projects
- Mentor capability specialists
- Define capability best practices

Usage Patterns

Creating a Specialist

1. Choose Target Domain (e.g., Data Analysis)
2. Learn Required Capabilities
   - data_visualization
   - chart_rendering
   - report_generation
3. Execute Domain Tasks Successfully
4. Build High Success Rate (>90%)
5. Apply for Specialist Certification
6. Receive Specialist Status

Finding a Specialist

1. Specify Domain Required
2. Filter by Proficiency Level
3. Review Specialist Profiles
4. Check Availability
5. Assign Task to Specialist

Building Cross-Domain Teams

Team Composition:
- 1x QUEEN (coordinates across domains)
- 3x Domain Specialists (each expert in one domain)
- 2x Generalists (handle overflow and simple tasks)

Benefits:
- Specialized expertise where needed
- Flexibility for varying workloads
- Clear escalation paths
- Knowledge sharing across domains

Domain Lifecycle

Domain Expansion

Domains grow and evolve:

  • **New Capabilities**: Add capabilities as domain expands
  • **Refined Requirements**: Update proficiency standards
  • **Sub-domains**: Create specialized sub-areas
  • **Best Practices**: Document and share patterns

Specialist Development

Track specialist growth:

  • **Capability Acquisition**: New capabilities learned
  • **Proficiency Improvements**: Success rate increases
  • **Certification Progress**: Advancement through levels
  • **Mentorship Activities**: Training other specialists

API Overview

Domain Management

  • List all available domains
  • Get domain details and requirements
  • Create custom domains
  • Update domain definitions

Specialist Management

  • List domain specialists
  • Register as specialist
  • Update specialist profile
  • View specialist performance metrics

Domain Assignment

  • Assign agent to domain
  • Set primary/secondary domains
  • Track domain proficiency
  • Manage specialist certifications

Marketplace

  • Browse marketplace offerings
  • Search for specialists
  • Share domain capabilities
  • Access best practices

Best Practices

  1. **Focused Start**: Master one domain before expanding
  2. **Build Deep Expertise**: Develop high proficiency in core domain
  3. **Maintain Quality**: Keep success rates high as you scale
  4. **Share Knowledge**: Contribute to domain marketplace
  5. **Cross-Train**: Develop secondary domains for versatility

Common Scenarios

Creating a Data Analysis Team

Required Specialists:
- 1x Data Analysis Expert (lead)
- 2x Data Visualization Specialists
- 1x Reporting Specialist
- 1x Generalist (support)

Expected Outcomes:
- 40% faster report generation
- 95% accuracy in insights
- Scalable to handle increased demand

Building an Integration Practice

Domain Focus: Integrations
Required Capabilities:
- api_call, webhook_handler, authentication
- data_connector, error_handling, monitoring

Specialist Requirements:
- Proficient level or higher
- Experience with 5+ integrations
- >90% success rate

Team Structure:
- 1x ADMIRAL (multi-capability lead)
- 3x Integration Specialists
- Shared knowledge base of patterns

See Also